home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 16 / CU Amiga Magazine's Super CD-ROM 16 (1997-10-16)(EMAP Images)(GB)[!][issue 1997-11].iso / CUCD / Readers / Windoze / PPshow.guide (.txt) < prev    next >
Amigaguide Document  |  1996-05-02  |  13KB  |  233 lines
  1.                             PPShow 4.0 User Manual
  2.                                  Feb 17, 1994
  3. Preface
  4. =======
  5. The programs and files in this distribution are freely distributable, but are
  6. also copyright (c) Nico Fran
  7. ois.  They may be freely distributed as long as
  8. no more than a nominal fee is charged to cover time and copying costs.
  9.    No commercial usage is permitted without written permission from the
  10. author.  Everything in this distribution must be kept together, in original
  11. unmodified form.
  12.    The above is generally known as freeware.
  13.    If you have suggestions or remarks about this program, or if you find
  14. any bugs, please let me know.
  15.    Contacting the author:
  16.      FidoNet:  2:292/603.10 (Nico Francois)
  17.      Internet: nico@augfl.be
  18.      Mail:     Nico Fran
  19.                Corbielaan 13
  20.                B-3060 Bertem
  21.                BELGIUM
  22.    If you can please use e-mail.  That way you'll stand a much better chance
  23. of getting a reply quickly.
  24.    PPShow 4.0 requires AmigaDOS Release 2 (Kickstart & Workbench 2.0) or
  25. higher to run.
  26.    24-bit to HAM8/HAM6 rendering routines and IFF24 parsing and decoding
  27. written by Rafael D'Halleweyn.
  28.    Chunky to planar routine based on a routine by Chris Green (who based his
  29. routine on one of Richard Addison).
  30.    This software is based in part on the work of the Independant JPEG Group.
  31. Contents
  32. ========
  33. 1. An introduction
  34. 2. Usage
  35. 3. Features
  36. 4. Note on crunching
  37. 1. An introduction
  38. ==================
  39.    PPShow was written to complement one of my other utilities, PowerPacker
  40. (a command and data cruncher).  It is used to show normal IFF ILBM files or
  41. ILBM files crunched with PowerPacker.  The decrunching is done automatically
  42. so the user doesn't have to know if a file is crunched or not.  From version
  43. 3.0 PPShow will now also play standard Opcode 5 animations. The ANIM Opcode 5
  44. format is used by most ANIM generating programs, including DPaint IV.
  45.    From version 4.0 on PPShow also plays ANIM Opcode 7 and ANIM Opcode 8
  46. animations.  It will also show GIF, JPEG and IFF24 bit pictures.  If your
  47. Amiga doesn't have the color capability to display a GIF (ECS machines) PPShow
  48. will show the GIF in 16 grayscales.  JPEGs and IFF24 pictures will be shown in
  49. HAM8 or in HAM6 (if your Amiga doesn't support HAM8).
  50.    PPShow uses 'powerpacker.library' and 'reqtools.library', so make sure
  51. these are present in your Libs: directory.  Double-click 'Install_libs' for
  52. an automatic installation.
  53. 2. Usage
  54. ========
  55.    PPShow can be used in several different ways.
  56. - First of all via the CLI:
  57.    If you enter 'PPShow ?' you will get a standard AmigaDOS usage template,
  58. enter 'PPShow ??' for more information.  You use PPShow like this:
  59.    PPShow {<file>|<dir>|-c} [ALL] [LO] [HI] [SHI] [PROD] [L=LACE]
  60.           [NL=NOLACE] [HAM] [TIME s] [CYCLE] [NO=NOOVERSCAN] [NOMOUSE]
  61.           [A2024 [15Hz]] [PAL] [NTSC] [VGA] [SUPER72] [LOOP] [NOFLICKER]
  62.           [MO=MAXOSCAN] [J=JIFFIES n] [T=TIMES n] [R=REPEAT] [NOANIM]
  63.    The program will by default load the specified ILBM file or ANIM file and
  64. display/play it.  If the file was crunched using PowerPacker 2.0 or higher
  65. PPShow will first decrunch it for you.  If the file was encrypted you will be
  66. prompted for the password.  You may specify more than one file on the command
  67. line and you may even use wildcards, PPShow will show all files one at a time,
  68. double buffering the display.
  69.    If you specify "-c" as a filename ('PPShow -c') PPShow will show you the
  70. contents of the clipboard (if it contains an ILBM).  ANIM files will not be
  71. played from the clipboard.
  72.    If you enter PPShow without options, you will be presented with a
  73. file requester.  Entering PPShow with a directory instead of a file as an
  74. argument will also get you a requester, but it will be positioned in the
  75. directory you specified.
  76.    There are several command line options:
  77.      ALL        : Enter subdirectories, show all pictures/animations.
  78.      LO         : Force screen to open in LORES        mode.
  79.      HI         :   ''    ''    ''   ''   HIRES         ''
  80.      SHI        :   ''    ''    ''   ''   SUPERHIRES    ''
  81.      PROD       :   ''    ''    ''   ''   PRODUCTIVITY  ''
  82.      LACE       : Force interlace on.
  83.      NOLACE     : Force interlace off.
  84.      HAM        : This switch is used to select HAM mode when no CAMG chunk
  85.                   is found.  If you don't specify this switch PPShow will
  86.                   assume a 6 plane screen is extra-halfbrite. Note that this
  87.                   switch does not force HAM mode, it merely instruct PPShow
  88.                   to use HAM mode in case of doubt.
  89.      TIME s     : Display pictures for 's' seconds.
  90.      CYCLE      : Start cycling automatically.
  91.      NOOVERSCAN : Disable overscan.
  92.      NOMOUSE    : No mouse pointer.
  93.      LOOP       : Display all pictures in a loop, press CTRL-D to abort.
  94.      PAL        : Use 'pal.monitor'.
  95.      NTSC       : Use 'ntsc.monitor'.
  96.      VGA        : Use 'multiscan.monitor'. Please note that when using VGA,
  97.                   LO puts the screen in EXTRALORES, HI in LORES and SHI in
  98.                   PRODUCTIVITY (same as PROD).
  99.      SUPER72    : Use 'Super72.monitor'.
  100.      A2024      : Use 'a2024.monitor'.
  101.      15Hz       : Put A2024 monitor into 15Hz, rather than 10Hz.
  102.      NOFLICKER  : Kickstart 3.0 only.  If possible use a non-interlaced
  103.                   monitor mode ('DoublePAL.monitor' or 'DoubleNTSC.monitor').
  104.      MAXOSCAN   : Use VIDEO_OSCAN instead of MAX_OSCAN.  Video overscan
  105.                   offers the maximum possible overscan, but is not as system
  106.                   friendly.
  107.      JIFFIES n  : Set a delay between frames in jiffies.  A jiffie is 1/50s
  108.                   (PAL) or 1/60s (NTSC).  During animation playback you may
  109.                   press F1 to F10 to control animation playback speed.  Press
  110.                   Return to use the default speed.
  111.      TIMES n    : Set number of times to play the animation.
  112.      REPEAT     : Select repeat mode instead of loop mode (see below).
  113.      NOANIM     : Don't play animations, just display the first frame.
  114.      DATATYPES  : Always use datatypes.
  115.    The difference between loop mode and repeat mode is the following: in
  116. loop mode PPShow expects the last two frames of the animation to be the same
  117. as the first two frames, this makes looping easy and above all fast (DPaint
  118. saves animations like this).  Some animations are not like this however and
  119. if you want these to loop correctly you must select repeat mode (REPEAT),
  120. PPShow will then simply restart the animation when it finishes (note that
  121. there may be a small hickup when the animation repeats because the first frame
  122. takes longer to draw than the rest).
  123.    PPShow can be made resident so it doesn't have to be loaded every time
  124. you use it, use the c: Resident command for this.  You can't make PPShow
  125. resident when it is crunched!!  The file is supplied as an uncrunched command
  126. file with the pure bit set.  PPShow is reentrant as well, so you can run it
  127. from several CLI's at the same time.  (Not that this is very useful, but it's
  128. possible :-)
  129.    Examples:
  130.     o PPShow dh0:pics/HAMpicWithoutCAMG.pic HAM
  131.     o PPShow dir/#?.pic TIME 5 LOOP
  132.        Show all files in directory 'dir' with a '.pic' suffix for 5 seconds
  133.        and loop until user presses CTRL-D.
  134.     o PPShow PICS:~(#?.info) NOOVERSCAN
  135.        Show all files on 'PICS:' NOT ending in '.info'. Disable overscan.
  136. - Via the WorkBench:
  137.    There are three different ways of using PPShow via the workbench: you
  138. can set the default tool of the (crunched) ILBM/ANIM file to 'PPShow', you
  139. can single click the PPShow icon and then extend-select one or more icons
  140. (use shift click, double-clicking the last one) or you can double-click the
  141. PPShow icon and specify a filename using the file requester.
  142.    You set the default tool by single clicking the icon of the picture and
  143. selecting 'Information' from the 'Icons' menu.  You will get a window with
  144. several gadgets in it, click in the string gadget where it says 'Default tool'
  145. and enter ':ppshow'.  PPShow should be in the root directory of your disk for
  146. this to work, if e.g.  it's in the system directory you should enter
  147. ':system/ppshow'.  Last of all select the 'Save' gadget.
  148.    Following tooltypes are recognized by PPShow (in the pictures' icon, not
  149. PPShow's icon):
  150.      HAM        : See CLI option.
  151.      TIME=s     : Display picture for 's' seconds.
  152.      CYCLE      : Start cycling automatically.
  153.      NOOVERSCAN : Disable overscan.
  154.      NOMOUSE    : No mouse pointer.
  155.      LORES      : Force screen to open in LORES        mode.
  156.      HIRES      :   ''    ''    ''   ''   HIRES         ''
  157.      SUPERHIRES :   ''    ''    ''   ''   SUPERHIRES    ''
  158.      PROD       :   ''    ''    ''   ''   PRODUCTIVITY  ''
  159.      LACE       : Force interlace on.
  160.      NOLACE     : Force interlace off.
  161.      PAL        : Use 'pal.monitor'.
  162.      NTSC       : Use 'ntsc.monitor'.
  163.      VGA        : Use 'multiscan.monitor'. Please note that when using VGA,
  164.                   LO puts the screen in EXTRALORES, HI in LORES and SHI in
  165.                   PRODUCTIVITY (same as PROD).
  166.      SUPER72    : Use 'Super72.monitor'.
  167.      NOFLICKER  : Kickstart 3.0 only.  If possible use a non-interlaced
  168.                   monitor mode.
  169.      MAXOSCAN   : Use VIDEO_OSCAN instead of MAX_OSCAN.  Video overscan
  170.                   offers the maximum possible overscan, but is not as system
  171.                   friendly.
  172.      JIFFIES=n  : Set a delay between frames in jiffies.  A jiffie is 1/50s
  173.                   (PAL) or 1/60s (NTSC).  During animation playback you may
  174.                   press F1 to F10 to control animation playback speed.  Press
  175.                   Return to use the default speed.
  176.      TIMES=n    : Set number of times to play the animation.
  177.      REPEAT     : Select repeat mode instead of loop mode (see below).
  178. NOTE: - Follow these steps to make a simple slideshow that runs by double-
  179.         clicking an icon:  Make a script file containing something like the
  180.         following line: 'PPShow #?.pic TIME 10 LOOP'.  Set this script's
  181.         default tool to 'c:IconX' and enter 'WINDOW=CON://///AUTO' in its
  182.         tooltypes.  Put the script in a directory containing pictures (all
  183.         ending in '.pic'!).  If you now double-click this scripts icon the
  184.         slideshow will start, press ESC or CTRL-D to end.
  185.       - PPShow will add '.pp' to the filename when the file wasn't found.
  186.         This is very useful in the Workbench enviroment: you can make an
  187.         icon for 'house.pic' but name the file 'house.pic.pp'.  Now the
  188.         WorkBench will show an icon with 'house.pic' as name, but if you
  189.         doubleclick it 'house.pic.pp' will be displayed. (As long as there
  190.         is no 'house.pic' file in the directory!)
  191.       - Drag as many monitor icons to the WbStartup or Monitors drawer as
  192.         your monitor allows.  For example: if you have a multiscan monitor
  193.         drag pal, ntsc and multiscan.monitor to your Monitors drawer.  If
  194.         you do this you will have maximum ease of use of PPShow.
  195. 3. Features
  196. ===========
  197.    - PPShow fully supports the 16.8 million colors and HAM8 mode of the AGA
  198.      (AA) chip set of the Amiga 4000 and Amiga 1200.
  199.    - Uses asynchronous I/O for very fast viewing, even from floppy or CD-ROM.
  200.    - Abort PPShow by pressing 'Q', CTRL-C or the right mouse button.  Press
  201.      CTRL-D to abort everything and to break a script.
  202.    - PPShow offers full overscan and monitor support: PAL, NTSC, VGA,
  203.      SUPER72 and A2024.
  204.    - Big pictures are opened on an autoscroll screen.  Simply run the mouse
  205.      pointer off the edge of the screen to scroll around.
  206.    - PPShow can be used as a simple slideshow tool.  It supports wildcards
  207.      and an ALL switch to simplify this.
  208.    - Deluxe Paint color cycling is supported, press <TAB> to (de)activate.
  209.      Up to 8 cycles are supported.
  210.    - Press 'M' to toggle the mouse pointer on/off.
  211.    - Plays ANIM Opcode 5, Opcode 7 and Opcode 8 animations.
  212.    - Supports a change of the color palette during the animation.  Special
  213.      care has been taken to eliminate color-flashing as seen in many other
  214.      animation players (including the now obsolete PPAnim :-).
  215.    - Press 'S' or the left mouse button to start/stop the animation.  Press
  216.      'N' to advance a frame (when stopped).
  217.    - Reads the 'DPAN' IFF chunk DPaint saves with animations to find the
  218.      rate at which to play the animation.  Note that user options override
  219.      this rate (JIFFIES=n).
  220.    - Supports datatypes (Workbench 3.0 or higher).
  221. 4. Note on crunching
  222. ====================
  223.    A lot of IFF ILBM files are already crunched with the standard ByteRun1
  224. compression.  PowerPacker will crunch these files even further (most of the
  225. time) but will not crunch them as well as uncrunched ILBM files.  So save IFF
  226. files uncrunched (if you can, e.g. with PixMate) before crunching them, this
  227. way you will get the best crunching results.
  228.                         As always, I hope you find this program useful!
  229. "Sometimes people can be oh so dense" - The Pixies
  230. (c) 1991-1994 Nico Fran
  231.                                    //
  232.                        Thanks to \X/ Amiga for being the best computer ever!
  233.